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USER CALLABLE KERNAL ROUTINES 



IMAMt 


AUUKCSO 




ACPTR 


$FFA5 


Input byte from IEEE bus 


CHKIN 


$FFC6 


Open logical file in R(X) for input 


CHKOUT 


$FFC9 


Open logical file in R(X) for output 


CHRIN 


$FFCF 


Input character from channel 


CHROUT 


SFFD2 


Output byte in R(A) to channel 


CIOUT 


SFFA8 


Output byte in R(A) to IEEE (serial) bus 


CLALL 


$FFE7 


Close all files 


CLOSE 


$FFC3 


Close logical file in R(A) 


CLRCHN 


$FFCC 


Close all open channels and restore default channels 


GETIN 


SFFE4 


Get character from keyboard; character is in R(A) 


IOBASE 


$FFF3 


Returns address of I/O page in R(X), R(Y) 


LISTEN 


$FFB1 


Command device # in R(A) to listen with attention 


LOAD 


$FFD5 


Load from device; R(A)=0 for load, 1 for verify 


MEMBOT 


SFF9C 


Sets bottom of memory to R(X), R(Y) if carry clear 
reads bottom of memory in R(X), R(Y) if carry set 


MEMTOP 


$FF99 


Sets top of memory to R(X), R(Y) if carry clear 
reads bottom of memory in R(X), R(Y) if carry set 


OPEN 


$FFC0 


Open file determined by SETLFS and SETNAM 


PLOT 


$FFF0 


Move cursor to R(X), R(Y) if carry clear 

redu oursor pusiiiun iiho n^A;, n^T; is carry bci 


RnTIM 




RoaH timfi /hhmm<:c\ Into R/A^ RfY^ R^V^ 


RFADQT 


3>r rot 


RpaH piirront I/O ctatiiQ nnH return in Rf'A\ 
ncdu ouilclll l/w oldlUo dliu iciuill III n^AA^ 


Kto 1 Un 


5rro/ 


Restore system default vectors 


OA V £ 




Qauo from MFMRPlT to R/Y\ R/V\ 
odvc llOm IVitlVIDWI IU n(A|, iMW 


SCNKEY 


$FF9F 


Scan keyboard; if key pressed, store in buffer 


SCREEN 


SFFED 


Read organization of screen into R(X), R(Y) 


SECOND 


$FF93 


Set secondary address after call to LISTEN 


SETLFS 


SFFBA 


Set logical file #, device #, and secondary address 


SETMSG 


$FF90 


Control printing of messages (uses bits 6, 7 of R(A)) 


SETNAM 


SFFBD 


Set filename — R(A)=length, R(X), R(Y)=lo, hi pointer to filename 


SETTIM 


SFFDB 


Set time 


SETMO 


$FFA2 


Set IEEE (serial) timeouts 


STOP 


$FFE1 


Check for stop key 


TALK 


$FFB4 


Command device in R(A) to talk 


TKSA 


$FF96 


Set secondary address for TALK (sa in R(A)) 


UDTIM 


$FFEA 


Update time 


UNLSN 


$FFAE 


Unlisten IEEE (serial) device 


UNTLK 


$FFAB 


Untalk IEEE (serial) device 


VECTOR 


SFF84 


Change system vectors 



BASIC TOKENS 



1 9A 
1 £0 


PIN U 


1 C7 
ID/ 


TUCM 

i n pin 




CHD 


i CO 
1 DO 


MOT 
INU I 


1 ici 


MCVT 
IN LA I 


i CO 


O I Pr 




RATA 


i Tfll 
1 IV 


_l_ 
T 


1 19 


I M PI IT ±t 
IIMrU I ff 


1 71 
1/1 




1 91 


I IN r U I 


1 79 
\ 1 £. 




1 14 


D I IV! 


1 79 
I/O 


I 
I 


1 1R 


□ CAn 
ntlMU 


1 7 A 
1 / ** 


f 


1 1R 


I PT 
LP I 


1 7C. 
1 / 3 


AMP) 

AINU 


1 17 
1 / 




1 7(5 
I / D 


OR 


1 1fl 
1 Jo 


n U IN 


1 77 
ill 




1 1Q 


I r 


1 7Q 
I/O 




1 Aft 


n P o I Unc 


1 7Q 

1 /y 




1 A"\ 


rjHQI I R 
oUoUd 


1 on 

1 Olfl 


OOlN 




PPTI IBM 
nP I UrrlN 




1 MT 
I IN 1 


1 vll 




-1 Q9 


ADC 
HDO 


i A A 
1 **** 


o I vjr 


1 oo 


1 (QP 

Uon 


1 AR 


\J IN 




CDC 

rnC 


1 AG 


\ A/ A | T 

VVMI I 


1 QC 


pne 


1*1 / 


LUAU 


-1 QC 
1 OD 


cnR 
oUn 


■i AO 


C A \ / P 

o A V L 


187 


nlN U 


i A Q 


vtnl r Y 


188 


LUu 


150 


DEF 


189 


EXP 


151 


POKE 


190 


COS 


152 


PRINT # 


191 


SIN 


153 


PRINT 


192 


TAN 


154 


CONT 


193 


ATN 


156 


LIST 


194 


PEEK 


157 


CLR 


195 


LEN 


158 


CMD 


196 


STR$ 


159 


SYS 


197 


VAL 


160 


OPEN 


198 


ASC 


161 


CLOSE 


199 


CHR$ 


162 


GET 


200 


LEFTS 


163 


NEW 


201 


RIGHTS 


164 


TAB < 


202 


MID$ 


165 


TO 


203 


- 254 unused 


166 


SPC < 


255 


IT 



PEEKS AND POKES 



COLOR 

POKE 646.X 
POKE 36879.X 

LIGHT PEN 

PEEK (36870) 
PEEK (36871) 

KEYBOARD 

POKE 650,128 
PEEK (203) 
PEEK (198) 



Set current color code 

Set screen and border color 

Horizontal position of light pen 
Vertical position of light pen 

Make all keys repeat 

Which key pressed (64 if none) 

# of character in keyboard buffer 



SOUND 

POKE 36874.X 



POKE 
POKE 
POKE 
POKE 



36875. X 

36876. X 

36877. X 

36878. X 



USER PORT 

POKE 37138, O 
POKE 37136, X 
POKE 37136.X 



Set frequency of low oscillator 
Set frequency of mid oscillator 
Set frequency of high oscillator 
Set frequency of noise oscillator 
Set volume 



Set all bits for input 
Set all bits for output 
Data register (input/output) 



RS - 232 REGISTERS 



CONTROL REGISTER 



COMMAND REGISTER 



BITS 


7 




I 


STOP BITS 


0- 1 STOP BIT 




1 - 2 STOP BITS 





6 



WORD LENGTH 


BITS 


DATA WORD LENGTH 


6 


5 






8 BITS 


/ 


r 




1 




6 


1 


1 


5 



3 2 








| BAUD RATE 


£ 








50 










75 




ft 




1 


1 


110 




1 






134.5 




1 




1 


150 




1 


1 


y 


300 




1 




1 


600 


1 








1200 










1800 










2400 



BASIC SYNTAX: OPEN#lf, 2, 0, "<control registerXcommand register>" 
If — Normal logical file id (1 - 255). If > 127 then linefeed follows carriage return 
<control register>— Single byte character required to specify baud rate. 
<control register> — Single byte character NOT required. 



BITS 



7l6l5| [T[ [f] [f] Q] [0] 



PARITY OPTIONS 


BITS 


OPERATIONS 


7 


6 


5 






J 


Parity disabled, none 
generated/received 


/ 




1 


Odd parity 
Receiver/transmitter 




1 


1 


Even parity 
Receiver/transmitter 


1 


/ 




Mark transmitted 
Parity check disabled 


1 


1 


1 


Space transmitted 
Parity check disabled 



DUPLEX 



FULL DUPLEX 

1 HALF DUPLEX 



HANDSHAKE 



- 3 LINE 

1 - X LINE 



□ 



NOT USED 



SCREEN AND BORDER COLOR COMBINATIONS 



POKE 36879, X 



BORDER 



SCREEN 





BLK 


WHT 


RED 


CYAN 


PUR 


GRN 


BLU 


YEL 


ORANGE 


LT. OR 


PINK 


LT. CYAN 


LT. PUR 


LT. GRN 


LT. BLU 


LT. YEL 


BLACK 


8 


9 


10 


11 


12 


13 


14 


15 


136 


152 


168 


184 


200 


216 


232 


248 


WHITE 


24 


25 


26 


27 


28 


29 


30 


31 


137 


153 


169 


185 


201 


217 


233 


249 


RED 


40 


41 


42 


43 


44 


45 


46 


47 


138 


154 


170 


186 


202 


218 


234 


250 


CYAN 


56 


57 


58 


59 


60 


61 


62 


63 


139 


155 


171 


187 


203 


219 


235 


251 


PURPLE 


72 


73 


74 


75 


76 


77 


78 


79 


140 


156 


172 


188 


204 


220 


236 


252 


GREEN 


88 


89 


90 


91 


92 


93 


94 


95 


141 


157 


173 


189 


205 


221 


237 


253 


BLUE 


104 


105 


106 


107 


108 


109 


110 


111 


142 


158 


174 


190 


206 


222 


238 


254 


YELLOW 


120 


121 


122 


123 


124 


125 


126 


127 


143 


159 


175 


191 


207 


223 


239 


255 



TABLE OF MUSICAL NOTES 



APPROX. 
NOTE 


VALUE 


APPROX. 
NOTE 


VALUE 


APPROX. 
NOTE 


VALUE 


APPROX. 
NOTE 


VALUE 


C 


135 


A# 


187 


G# 


217 


F# 


233 


c# 


143 


B 


191 


A 


219 


G 


235 


D 


147 


C 


195 


A# 


221 


G# 


236 


D# 


151 


C# 


199 


B 


223 


A 


237 


E 


159 


D 


201 


C 


225 


A# 


238 


F 


163 


D# 


203 


C# 


227 


B 


239 


F# 


167 


E 


207 


D 


228 


C 


240 


G 


175 


F 


209 


D# 


229 


C# 


241 


G# 


179 


F# 


212 


E 


231 






A 


183 


G 


215 


F 


232 







SPEAKER COMMANDS: 



WHERE X CAN BE: 



POKE 36878, X 
POKE 36874, X 
POKE 36875, X 
POKE 36876, X 
POKE 36877, X 



Oto 15 
128 to 255 
128 to 255 
128 to 255 
128 to 255 



FUNCTION 



sets volume 
plays tone 
plays tone 
plays tone 
plays "noise" 



VIC MEMORY MAP 




SCREEN RAM 



4K RAM 



3K 

EXPANSION 
RAM 



1K RAM 



I/03 



I/02 



COLOR 



4K I I/O0 
CHARACTER 
ROM 



$IFFF 
$IEOO 

$1000 

$0400 
$0000 

$9C00 
$9800 
$9600 
* $9100 
$9000 
$8000 



